home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1997 March / macformat-048.iso / Shareware Plus / Comms / NetsGB 1.0 / GBnote next >
Encoding:
Text File  |  1996-12-02  |  7.3 KB  |  106 lines  |  [TEXT/ttxt]

  1.  
  2. NetsGB v. 1.0 Note
  3. Written by Eunil Kim, onil@left.kier.re.kr
  4. Copyleft Ω 1996
  5.  
  6. NetsGB is, reserved only for Mac users,  an AppleScript™ agent application running in conjunction with Netscape Navigator™. It saves the HTML source of the Netscape's frontmost window with all shown other sources, and corrects the URLs to let surf the WWW starting from the saved HTML file just like a bookmarked web page.
  7.  
  8. To use NetsGB, you should have a Macintosh equipped with System 7.0+ and AppleScript 1.1+ for Netscape Navigator 1.1N+ with 1+ Mb(?) of RAM free. Whenever you want to save the Netscape's window that you are currently looking at, just only activate NetsGB.
  9.  
  10. You can (but not always) obtain the NetsGB and documentation from: http://left.kier.re.kr/NetsGB/GBmain.html
  11.  
  12. NetsGB is my first public agent (background running and selfesteemware application) written in AppleScript 1.1. Its name is abbreviated from a Good (not Big in 1984) Brother of Netscape (Have you heard if he has a brother? No? Yes! he has just right now!). As the name indicates, NetsGB launches Netscape, waits your selection, commands him to save a  frontmost window including all shown sources in your local hard disk and/or correct the URL of the saved source HTML file in order to allow you to surf the web world. However, the NetsGB shall consequently be quitted whenever you quit the Netscape (Now, you may see why I named NetsGB instead of a Big Brother of Netscape, NetsBB for example. If you don't like my way, you may write some very powerful agent and name it by yourself!!!!!! We have a right to name something created by ourselves. Don't you agree???? No? Forget it!!!).
  13.  
  14. Copyleft Ω 1996 by Eunil Kim. 
  15. Feel free to do anything with this agent. Change it (for the better or worse), keep, share or distribute it (with/without this note) and even sell it for our profit, whatever, just do others a favour. Please use this software at our own risk, we assume no responsibility for any damage caused by this agent. The author don't refuse a donation for the future development(?). Notice 'donation' means here any sort of matters. I'll leave it to you to judge - selfesteemware. However, I'd like $5+ in cache.
  16. If you are a stealthy user without charity and even have any question on my NetsGB, please don't contact me:
  17. Eunil Kim, Hoypyong 459, Dongu, Daejon, South Korea
  18.  
  19.  
  20. System Requirements
  21. Macintosh that can run Netscape Navigator
  22. • System 7.0+ (tested with System 7.5.x)
  23. • Netscape Navigator 1.1+ (tested with Netscape 2.02)
  24. • AppleScript 1.1+ (tested with AppleScript 1.1 in US and Korean Dialect)
  25.  
  26. Installation
  27. • Just decode it, if it is encoded, and put it to any folder. 
  28. • Confirm if there exist AppleScript, AppleScriptLib extensions and Scripting Additions folder in the Extensions folder of System folder. (Install AppleScript according to System Installation procedure, if necessary.)
  29.  
  30. Some Features
  31. • Originally, NetsGB uses the name of Netscape Navigator as Netscape.
  32. • NetsGB saves only once the current-frontmost window of Netscape.
  33. • Whenever NetsGB is being activated and brought into the frontmost application, there are two actions:
  34.        -  saving the Netscape's window, or
  35.        -  waiting for ending the NetsGB's session.
  36. • NetsGB shows an amount of saved quantity in bytes at the end of NetsGB's session.
  37. • NetsGB saves the Netscape's window in the target folder, of which the default name is the window's title, in two parts:
  38.        -  a current HTML text file in the target folder as its own name, or home.html if no exist, and
  39.        -  other viewed source files in the source sub-folder, whose name is derived from the prefix of the HTML file name replacing its suffix such as _imx instead of .html (e.g., home_imx vs home.html).
  40. • Note that the URL in the HTML source file should be corrected if the sub-folder name is changed.
  41.  
  42. Before Start (Recommendations)
  43. 1) Change the name of Netscape Navigator into Netscape in short (not forcibly necessary).
  44. 2) Set Preferences in the Options menu of Netscape
  45.        -  Use a local file as Home Page Location in Appearance of the General Preferences sub-menu (optional).
  46.      -  Set Netscape as View Source in Applications of the General Preferences sub-menu (forcibly necessary)
  47.   -  Increase a little bit the Cache Size and Check Documents: Once Per Session in Cache of the Network Preferences sub-menu (recommendable).
  48.  
  49. First Quick Start
  50. 1) Launch Netscape and NetsGB successively if Netscape Navigator is renamed as Netscape,
  51. or
  52. 1) Launch NetsGB agent, and find Netscape position in NetsGB's dialog.
  53. 2) Surf the Web world with Netscape and find a target Web page.
  54. 3) Activate NetsGB selecting its own name in the Application menu at the right-uppermost corner on the screen, or simply double-clicking it in the Finder.
  55. 4) Put the folder name when NetsGB prompting a dialog and click Save button.
  56. 5) Quit the Netscape and click Au revoir... button when NetsGB's ending dialog is prompting.
  57.  
  58. Brief(Detail) Operations
  59. • To save a current-frontmost window of Netscape which is already opened
  60. 1) Launch NetsGB agent.
  61. 2) Wait NetsGB letting Netscape go Home and Back from the current-frontmost window.
  62. 3) Choose and put the folder name when NetsGB's dialog prompting.
  63.  
  64. • To save the window while Netscape and NetsGB are running on background
  65. 1) Activate NetsGB.
  66. 2) Choose and put the folder name when NetsGB's dialog prompting.
  67.  
  68. • To quit NetsGB while Netscape is running
  69. 1) Activate NetsGB agent on the following conditions:
  70.        - if the default home page window is frontmost, or
  71.        - if the frontmost window is already saved.
  72. 2) Choose Quit of the NetsGB 's File menu while NetsGB showing its menu.
  73.  
  74. • To see the saved HTML source file by Netscape
  75. 1) Double-click the saved HTML source file,
  76. or Select Open File in the File menu of Netscape and find the saved HTML source file,
  77. or Drag and drop the saved HTML source file on the Netscape application.
  78.  
  79. • To save again the uncompleted HTML source file 
  80. 1) Activate NetsGB agent when the uncompleted HTML source file is viewed by Netscape,
  81. or Drag and drop the uncompleted HTML source file on the NetsGB agent.
  82.  
  83. • To change the names of the HTML text file and the source sub-folder
  84. 1) Change both names of the HTML text file and the source sub-folder in keeping their prefix in the Finder.
  85. 2) Drag and drop the HTML text file on the NetsGB agent.
  86.  
  87. Treating an URL in FRAME formatted HTML pages
  88. 1) Choose New Window with this Link when Netscape shows a menu  on the window while clinking a target URL and waiting a moment.
  89. 2) Activate NetsGB agent.
  90. Note that NetsGB can merely save a FRAME formatted page in a way of getting the URL of the current-frontmost window. In general, a new Web page, due to clicking a URL in the FRAME formatted window, does not change the URL of the window. Saving this page doesn’t, therefore, effect, but the first-original FRAME formatted page!!!!
  91.  
  92. Some Limitations
  93. • Can't digest a very big HTML text file, which has many many ... URLs.
  94. • Hard to deal with some FRAME formatted HTML page.
  95. • Don’t yet correct URL used in Java Script.
  96. • Fail to support erroneous HTML sources, of course.
  97.  
  98. Bragging again
  99. This work is copyleft Ω Eunil Kim 1996, all lefts deserved. Please repost this or make it publicly accessible via FTP, mail server, or archive site with my implicit permission. If you have a suggestion on NetsGB or/and on this note, please let me know for the next(?) version.
  100.  
  101. December 1, 1996
  102.  
  103. Eunil Kim
  104. onil@left.kier.re.kr
  105. Hoypyong 459, Dongu, Daejon, South Korea
  106.